home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
AmigActive 10
/
AACD 10.iso
/
AACD
/
Utilities
/
PalmLink
/
developer
/
palmlink-arexx.doc
next >
Wrap
Text File
|
2000-01-06
|
12KB
|
554 lines
TABLE OF CONTENTS
PALM_Accept
PALM_AddSyncLogEntry
PALM_CloseSocket
PALM_EndOfSync
PALM_Explain
PALM_GetBaudRate
PALM_GetDBInfo
PALM_GetStorageInfo
PALM_GetSysInfo
PALM_LastError
PALM_NetSyncInfo
PALM_OpenConduit
PALM_OpenSocket
PALM_ResetLastSyncPC
PALM_ResetSystem
PALM_SysTime
PALM_UserInfo
PALM_Accept
NAME
PALM_Accept -- accept a connection
SYNTAX
PALM_Accept(socket,<parameters>)
FUNCTION
Wait for a connection request from Palm Pilot, and accept it. If
there was no connection until Timeout, a timeout error will be
returned.
Usually, the connection is started by pressing the HotSync button
on the cradle.
INPUT
socket -- socket name
PARAMETERS
TIMEOUT/K/N -- Timeout until this function returns, in seconds.
Defaults to 30 seconds.
RESULT
nothing
NOTE
BUGS
SEE
PALM_AddSyncLogEntry
NAME
PALM_AddSyncLogEntry -- add an entry to the HotSync log
SYNTAX
PALM_AddSyncLogEntry(socket,<parameters>)
FUNCTION
Add an entry to the HotSync log. The user can read the last HotSync
log with the HotSync tool of the Palm Pilot.
INPUT
socket -- socket name
PARAMETERS
ENTRY/A -- Entry to be added to the HotSync log
NOLF/S -- Do not add a line feed to the entry
RESULT
NOTE
BUGS
SEE
PALM_CloseSocket
NAME
PALM_CloseSocket -- close a socket to a Palm Pilot
SYNTAX
PALM_CloseConduit(socket)
FUNCTION
Close a socket to a Palm Pilot. Make sure to close all data bases
before. PalmLink won't do this for you.
INPUT
socket -- socket name of the socket to be closed
RESULT
nothing
NOTE
Make sure to close the socket even if an ARexx error occured
and the script is aborted. Otherwise you will not be able to
connect to this socket again!
BUGS
Currently, a socket name is global and shared by all ARexx
scripts running. Please be careful not to produce a clash,
make sure only one script is running simultaneously.
SEE
PALM_OpenSocket
PALM_EndOfSync
NAME
PALM_EndOfSync -- terminate all database accesses
SYNTAX
PALM_EndOfSync(socket,<parameters>)
FUNCTION
Closes the Pilot database. After you called this function, you
should close the connection.
*NEVER* forget to call PALM_EndOfSync when you called
PALM_OpenConduit. PalmLink won't do this for you.
INPUT
socket -- socket name
PARAMETERS
STATUS/N -- Status code, optional.
RESULT
nothing
NOTE
BUGS
SEE
PALM_Explain
NAME
PALM_Explain -- explain an error code
SYNTAX
PALM_Explain(socket,<parameters>)
FUNCTION
Explains the provided error code.
If the error was a DOS error code, it will be explained as
well, using dos.library.
INPUT
socket -- socket name
PARAMETERS
CODE/A -- error code to be explained
RESULT
Explained error code
NOTE
BUGS
SEE
PALM_GetBaudRate
NAME
PALM_GetBaudRate -- get negotiated baud rate
SYNTAX
PALM_GetBaudRate(socket)
FUNCTION
The currently negotiated baud rate with the Palm is
returned. Only valid after PALM_Accept has returned.
INPUT
socket -- socket name
RESULT
Negotiated baud rate.
NOTE
BUGS
SEE
PALM_GetDBInfo
NAME
PALM_GetDBInfo -- get information about the database
SYNTAX
PALM_GetDBInfo(socket,<parameters>,stem)
FUNCTION
The passed stem variable is filled with information
about the database with the number provided in INDEX.
INPUT
socket -- socket name
stem -- name of the stem variable to be filled
PARAMETERS
INDEX/N/A -- Index of the database entry to be read.
Start with 0, then traverse with STEM.INDEX+1.
ROM/S -- If passed, all ROM databases are read
instead of the RAM databases
CARD/K/N -- Select the card to be read. Defaults to
card 0.
STEM
NAME -- Name of the entry
INDEX -- Index of this entry
CREATED -- Creation date (YYYY-MM-DD HH:MM:SS)
MODIFIED -- Modification date (YYYY-MM-DD HH:MM:SS)
BACKUPPED -- Backup date (YYYY-MM-DD HH:MM:SS, or ---)
VERSION -- Version number
CREATOR -- Creator ID
TYPE -- Type ID
FLAGS -- Flags (as decimal, see include file)
EXCLUDE -- Exclude flags (as decimal, see include file)
RESULT
0 if there are no further entries, else any other number
NOTE
BUGS
SEE
PALM_GetStorageInfo
NAME
PALM_GetStorageInfo -- get information about a card
SYNTAX
PALM_GetStorageInfo(socket,<parameters>,stem)
FUNCTION
The passed stem variable is filled with information
about the card with the number provided in CARD.
INPUT
socket -- socket name
stem -- name of the stem variable to be filled
PARAMETERS
CARD/N -- Select the card to be read. Defaults to
card 0.
STEM
NAME -- Name of the card
MANUFACTURER -- Card manufacturer
CARDNO -- Number of the current card. Iterate with
CARD=CARDNO+1
VERSION -- Version
CREATED -- Creation time (YYYY-MM-DD HH:MM:SS)
ROMSIZE -- Size of permanent memory
RAMSIZE -- Size of volatile memory
RAMFREE -- Size of free RAM space
RESULT
0 if there are no further entries, else any other number
NOTE
BUGS
SEE
PALM_GetSysInfo
NAME
PALM_GetSysInfo -- get information about the system
SYNTAX
PALM_GetSysInfo(socket,stem)
FUNCTION
The passed stem variable is filled with information
about the system.
INPUT
socket -- socket name
stem -- name of the stem variable to be filled
STEM
SYSNAME -- Name of the system
ROMVERSION -- Version of the OS
LOCALIZION -- Localizion code
RESULT
NOTE
BUGS
SEE
PALM_LastError
NAME
PALM_LastError -- return the last error code
SYNTAX
PALM_LastError(socket)
FUNCTION
Return the code of the last error. Negative codes are PalmLink
errors. Positive are DLP error codes.
INPUT
socket -- socket name
RESULT
error code
NOTE
BUGS
SEE
PALM_NetSyncInfo
NAME
PALM_NetSyncInfo -- get/set information about netsync
SYNTAX
PALM_NetSyncInfo(socket,<parameters>,stem)
FUNCTION
The passed stem variable is filled with information
about the netsync. Optionally, some fields can be changed
first, using the parameters.
INPUT
socket -- socket name
stem -- name of the stem variable to be filled
PARAMETERS
LANSYNC/K/N -- Lansync code (?)
HOSTNAME/K -- Host name
HOSTADDRESS/K -- Host address
HOSTSUBNETMASK/K -- Host subnet mask
STEM
LANSYNC -- Lansync code (?)
HOSTNAME -- Host name
HOSTADDRESS -- Host address
HOSTSUBNETMASK -- Host subnet mask
RESULT
NOTE
BUGS
SEE
PALM_OpenConduit
NAME
PALM_OpenConduit -- Initialize database access
SYNTAX
PALM_OpenConduit(socket)
FUNCTION
Open the Pilot database for access. You must call this function
after a successful PALM_Accept.
INPUT
socket -- socket name
RESULT
nothing
NOTE
BUGS
SEE
PALM_OpenSocket
NAME
PALM_OpenSocket -- open a socket to a Palm Pilot
SYNTAX
PALM_OpenSocket(socket,<parameters>)
FUNCTION
Open a new socket to a Palm Pilot. The Pilot must be connected to
a serial port. As default, the internal serial port is used.
INPUT
socket -- socket name of the socket to be opened
PARAMETERS
SD=DEVICE/K -- serial device the pilot is connected to
SU=UNIT/K/N -- serial unit
SB=MAXBAUD/K/N -- maximum baud rate supported by the device
RESULT
nothing
NOTE
BUGS
Currently, a socket name is global and shared by all ARexx
scripts running. Please be careful not to produce a clash,
make sure only one script is running simultaneously.
SEE
PALM_CloseSocket
PALM_ResetLastSyncPC
NAME
PALM_ResetLastSyncPC -- clear LastSyncPC
SYNTAX
PALM_ResetLastSyncPC(socket)
FUNCTION
Reset the LastSyncPC field in the UserInfo.
INPUT
socket -- socket name
RESULT
nothing
NOTE
BUGS
SEE
PALM_ResetSystem
NAME
PALM_ResetSystem -- reset the Palm Pilot
SYNTAX
PALM_ResetSystem(socket)
FUNCTION
Reset the Palm Pilot when the connection is closed.
INPUT
socket -- socket name
RESULT
nothing
NOTE
BUGS
SEE
PALM_SysTime
NAME
PALM_SysTime -- get/set system time
SYNTAX
PALM_SysTime(socket,<parameters>,stem)
FUNCTION
The passed stem variable is filled with information
about the system time. Optionally, some fields can be changed
first, using the parameters.
INPUT
socket -- socket name
stem -- name of the stem variable to be filled
PARAMETERS
D=DAY/K/N -- Change the day
MO=MONTH/K/N -- Change the month (1..12)
Y=YEAR/K/N -- Change the year (please use 4 digits!)
H=HOUR/K/N -- Change the hour
MI=MINUTE/K/N -- Change the minute
S=SECOND/K/N -- Change the second
STEM
TIME -- Current time (YYYY-MM-DD HH:MM:SS)
SECOND -- Current second
MINUTE -- Current minute
HOUR -- Current hour
DAY -- Current Day
MONTH -- Current Month (1..12)
YEAR -- Current Year (4 digits)
RESULT
NOTE
BUGS
SEE
PALM_UserInfo
NAME
PALM_UserInfo -- get/set information about the user
SYNTAX
PALM_UserInfo(socket,<parameters>,stem)
FUNCTION
The passed stem variable is filled with information
about the user. Optionally, some fields can be changed
first, using the parameters.
INPUT
socket -- socket name
stem -- name of the stem variable to be filled
PARAMETERS
USERNAME/K -- Set a new user name
PASSWORD/K -- Set a new password (Encrypted)
STEM
USERID -- User ID
VIEWERID -- Viewer ID
LASTSYNCPC -- LastSyncPC code
LASTSYNC -- Time of last sync attempt (YYYY-MM-DD HH:MM:SS)
SUCCESSFULSYNC -- Time of last successful sync (YYYY-MM-DD HH:MM:SS)
USERNAME -- User name
PASSWORD -- Password (Encrypted)
RESULT
NOTE
BUGS
SEE
PALM_ResetLastSyncPC